home *** CD-ROM | disk | FTP | other *** search
/ NeXT Education Software Sampler 1992 Fall / NeXT Education Software Sampler 1992 Fall.iso / READMEFiles / Resound.README < prev    next >
Text File  |  1992-08-29  |  5KB  |  139 lines

  1. Resound
  2. by Sean Luke
  3.  
  4.  
  5. About the Program
  6. June 15, 1992
  7.  
  8. This program was conceived in the Summer of 1991, and written, little by little over a year or so.  Student life is fraught with exams, y'know.  A lot of it is spaghetti OOP, since I was learning the NeXTSTEP environment as I went.  This really shows...oh, well.
  9.  
  10. The idea of the program is to make it easier for researchers with a little programming ability to make their great sound editing ideas come to life without having to write out a full-blown application.  This is accomplished by creating an environment where all a would-be programmer has to write is an add-in module object that communicates with the main program.  Without modules, this program isn't too useful.  With them, it shows a lot of potential, I think.
  11.  
  12. The program is not even close to complete.  In addition to printing, 16-bit recording, and a properly-working view update mechanism, the program could stand quite a few more sample modules and design changes.  Send me e-mail if you have ideas.
  13.  
  14. The program comes complete with source code, under the GNU license.  Have fun!
  15.  
  16.  
  17.  
  18. About the Author
  19. As of this writing, I'm an undergraduate at Brigham Young University, majoring in Computer Science and minoring in Music (Piano) and English Comp.  Fun, huh?  I'm looking for a few good graduate schools, particularly programs in computers and music, sound, or sound production.  If you have any leads, I would appreciate hearing about them.
  20.  
  21. Sean Luke
  22. Brigham Young University
  23. sean@digaudio.byu.edu
  24.  
  25.  
  26. TOOLS
  27. There are many tool panels.  These panels give access to information about sounds, and allow scrollview zooming and sound recording and playback.  All can be closed except the Console.  To reopen any of them, choose the appropriate menu item in the Tools menu.
  28.  
  29. Console
  30. The Console handles the playing and recording sounds, and allows volume settings in stereo (which cannot be done with the NeXT volume keys).
  31.  
  32. Information
  33. The information panel automatically shows the sound type, number of samples, number of channels (mono:1 stereo:2), and number of seconds of a sound.  It also tells if the sound is fragmented, which happens during cut/copy/paste editing and could considerably slow down other editing procedures.  To de-fragment the sound, press the Compact button.
  34.  
  35. Selection
  36. The Selection panel shows the start, end, and length of the current selection in number of samples and number of seconds.
  37.  
  38. View
  39. The View panel shows the start, end, and length of the current visible sound in number of samples and number of seconds.
  40.  
  41. Zoom
  42. The Zoom panel allows zooming in or out.  The buttons on the bottom work as follows:
  43.  
  44.         All In        Zooms in to maximum detail
  45.         <<<            Zoom in significantly 
  46.         <<
  47.         <            Zoom in a bit
  48.         >            Zoom out a bit
  49.         >>
  50.         >>>            Zoom out significantly
  51.         All In        Zooms out to minimum detail
  52.         
  53.         To Selection    Zooms to fit the selection into the window
  54.         
  55. The scroll bar allowsw precise zooming values.  The small text field shows the current reduction factor, which varies between zero and one.
  56.  
  57. OTHER PANELS
  58. Pasteboard Converstion  
  59.     Allows conversion of the pasteboard sound by number of     channels and sample rate.
  60. Record Format  
  61.     Is not currently implemented.
  62. Preferences
  63.     Several application preferences are currently implemented:
  64.     
  65.         Update Selection in Real Time  will constantly update
  66.         the Selection panel as the selection changes with
  67.         the mouse.  This is rather slow, but precise.
  68.         
  69.         Update Zoom in Real Time will change the zoom as
  70.         the Zoom scroll bar moves in real time.  This is also
  71.         slow, but precise.
  72.     
  73.         Update View in Real Time will do the same for the View
  74.          panel; however, non-real-time view update doesn't
  75.         work properly yet—you need to click on the scroll bar
  76.         to update the view panel.
  77.         
  78.     In addition, Preferences allows either oscilliscopic or min/max
  79.     display.  The differences between these displays is only
  80.     visible when the sound is zoomed completely out.
  81.  
  82.  
  83. THE INFO MENU
  84. GNU License
  85. Read this.
  86.  
  87. Bugs and Problems
  88. List of known bugs at publishing time.  If you know any more, please send e-mail!
  89.  
  90. About Modules
  91. A short introduction to the art of writing modules to add functionality to this program.
  92.  
  93.  
  94.  
  95. THE EDIT MENU
  96. Convert Pasteboard...
  97. Converts the pasteboard sound by number of channels and sample rate.
  98.  
  99. Compact
  100. Compacts fragmented sounds.  See the Information window under Tools.
  101.  
  102.  
  103. THE ZOOM MENU
  104. To Selection
  105. Zooms to fill the window with the current selection.  Not yet implemented.
  106.  
  107. In
  108. Zooms in.
  109.  
  110. Out
  111. Zooms out.
  112.  
  113. All In
  114. Zooms to maximum detail.
  115.  
  116. All Out
  117. Zooms to show the entire sound in the window.
  118.  
  119.  
  120.  
  121. THE MODULES MENU
  122. Modules should have menu options in this menu.  Modules that come with this program include:
  123.     Change Amplitude  changes the volume of the sound.
  124.     Double      tries (in vain) to double the frequency of the
  125.             sound without changing the length.
  126.     Halve    tries the same with halving the frequency.
  127.     Reverse     reverses the entire sound.  Channels are flipped.
  128.  
  129.  
  130.  
  131. THE TOOLS MENU
  132. Calls up tool panels discussed previously
  133.  
  134.  
  135. HOT KEYS
  136. As you might have noticed, the Console insists, or demands to remain the top window.  This is so it can remain visible at all times, and also so it can receive keyboard messages from the number pad.  Press the Hot Keys button above to see which number pad keys correspond to buttons on the Console.
  137.  
  138.  
  139. Go to it!